home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 26 / Cream of the Crop 26.iso / bbs / bk2ad106.zip / bink2adept.HLP (.txt) < prev    next >
OS/2 Help File  |  1997-07-30  |  15KB  |  339 lines
  1.  
  2. ΓòÉΓòÉΓòÉ 1. Binkley 2 AdeptXBBS Outbound Convertor ΓòÉΓòÉΓòÉ
  3.  
  4.  
  5. ΓòÉΓòÉΓòÉ 1.1. About 'n' history ΓòÉΓòÉΓòÉ
  6.  
  7. This is just a short help for setting up Bink2Adept.
  8.  
  9.  
  10. I 've started this small little tool because someone called Hagar was too lazy to plug
  11. Binkley styled outbound into AdeptXBBS WC builds. (I ve heard of another Hex, who is even too lazy
  12. to plug in squish support)
  13.  
  14. Anyway .. after some hours of tests it was just fun. First version (plain CMD)
  15. worked fine, but it seems that some sysops were not able to use it, so i decided to rewrite
  16. it using VX-REXX - adding a complete setup and some other stuff.
  17.  
  18. History
  19.  
  20.  
  21. 30.07 V1.06
  22. -found a bug i report once to Hagar, when he was fixing gatekeeper:
  23.  When Bink2Adept tries to archieve new mail into an existing A.* packet, which will be send
  24.  at the same time or modiefed in another way, some strange behavior occours
  25.  anyway, if bink2adept trapps or just run through w/o reporting problems, mail was lost always!
  26.  Sorry for that .. didn't think bout it.
  27.  Implement a work around ...:
  28.  If archieving new mail into an existing A.* fails new mail will be left in your binkley styled
  29.  outbound. They will be converted into Adept's outbound on next run.
  30.  I your default archiever should exit with errorlevel 0 / RETCODE 0. Any other value will be
  31.  handled as an error.
  32.  
  33.  Also on multiline systems there may be a problem, when Bink2Adept will be started more than once.
  34.  When starting B2A it will now test if a named rxqueue exists. If it exists B2A pulls out
  35.  some session infos from the other active B2A. Otherwise it creates a new RXQueue and pushes
  36.  session infos into it. <<< I NEED some tests!!!
  37.  This is a bit dangerous, because when B2A aborts rxqueue can still exist. This will B2A prefent
  38.  itself to restart again. Include in this archieve is a small cmd: removeque.cmd
  39.  Start this rexx script if this happens. If u still cannot start B2A u must reboot!
  40.  Added some reports to the log file .. PLEASE report, if there are still problems!!!
  41.  
  42.  Beside this i started a new outbound manager. On Main screen press F5.
  43.  In this release all functions are disabled or even not visible .. not ready yet, but i think
  44.  i have to correct upper bugs immediately.
  45.  
  46.  Changed the way B2A looks for bink2adept.ini . Now u may start B2A from any directory.
  47.  
  48.  removed some pretty much useless "IF THEN - DO SELECT" structs
  49.  
  50.  
  51. 28.07 V1.05
  52. -changed Netmail area handling. Now Netmailarea will be identified by flags - till now
  53.  Bink2Adept searched for name "NETMAIL" - but yes ... you may name it as you want.
  54.  
  55.  
  56. 27.07 V1.04
  57. -some minor stuff
  58.  
  59. 26.07 V1.03
  60. -added a resize event into menu tools - i use 1024x768 ... everthing was displayed here
  61.  but on lower resolution parts of the window where out of visible
  62.  (hey wikk .. u should upgrade your 256kb videocard)
  63. -rewrite help file - now you should get correct help
  64. -some cosmetic stuff
  65.  
  66.  
  67. 25.07. V1.02
  68. -parsing line args was not correct
  69. -mismatched filenames for message_areas.squish and squish.cfg.new
  70.  
  71.  
  72. ΓòÉΓòÉΓòÉ 2. SETUP ΓòÉΓòÉΓòÉ
  73.  
  74. SETUP
  75.  
  76.  
  77. ΓòÉΓòÉΓòÉ 2.1. Setup ΓòÉΓòÉΓòÉ
  78.  
  79. First of all run SETUP of BINK2ADEPT:
  80.  
  81.       BINK2ADEPT.EXE SETUP   (or even without any argument)
  82.  
  83. On main window enter Setup (F2). After all HIT SAVE !!!
  84.  
  85. If you have the one of the following lines in your config.sys (i'm sure you have), most of
  86. the required settings should be ok.
  87.  
  88.             SET ADEPT=C:\ADEPT
  89.             SET APATH=C:\ADEPT
  90.  
  91. Further i assume adept's default pathes and filenames are used:
  92.  
  93. <Adept main directory>\GATEKPR.CTL       => will look into for your default archiever statement
  94. <Adept main directory>\SYSTEM\ADDRESSES  => first address in this file must be your main aka
  95. <Adept main directory>\MESSAGE_BASES     => default directory where your msgbase is stored
  96.  
  97. Any difference MUST be changed manually! So go through all settings.
  98.  
  99. Next open your mailer settings: CONFIG -> ACTIVE LINE -> MAILER SETTINGS
  100.  
  101. EDIT MAIL PROC CMD:     C:\OS2\Cmd.Exe /c C:\Adept\Mail.Cmd 1 %s
  102.                                                             |  |
  103.                                            line number <-----  |
  104.                                           inbound path <--------
  105.  
  106. Now open your mail.cmd and add the following line AFTER your tosser:
  107.  
  108.         start /PM BINK2ADEPT.EXE TOSS %1 %2
  109.  
  110. Command line switches:
  111.  
  112.         BINK2ADEPT.EXE TOSS   =  Look into Binkley's outbound and convert
  113.  
  114.         BINK2ADEPT.EXE SETUP  =  run SETUP mode
  115.  
  116.  
  117. ΓòÉΓòÉΓòÉ 2.2. MAIL.CMD ΓòÉΓòÉΓòÉ
  118.  
  119.  
  120. Here a copy of my mail.cmd
  121.  
  122. rem  ======================================
  123. rem  ----Adept Request Prozessor
  124. rem  ======================================
  125.  
  126. c:
  127. cd \adept\tools\arp2
  128. start /PM arp200.exe %1 %2
  129.  
  130. rem  ======================================
  131. rem  ----New NET/ECHOMAILS tossen
  132. rem  ======================================
  133.  
  134. c:
  135. cd \adept\tools\fastecho
  136. fastech2 toss -c
  137. fastech2 afix
  138.  
  139. rem  ======================================
  140. rem  ----FILE TICER AND FILEMGR
  141. rem  ======================================
  142.  
  143.  
  144. cd \adept\tools\mtic
  145. MTIC2.EXE SCAN
  146. MTIC2.EXE TICHATCH
  147.  
  148.  
  149. rem  ======================================
  150. rem  ----SCAN FOR ECHO OUTBOUND (Squish base only)
  151. rem  ======================================
  152.  
  153. cd \adept\tools\fastecho
  154.  
  155. fastech2 scan -SQ
  156.  
  157. rem  ======================================
  158. rem  ----SCAN FOR NET OUTBOUND (FIDO/*MSG only)
  159. rem  ======================================
  160.  
  161. cd \adept\tools\itrack
  162.  
  163. itros2 /Cadept.cfg scan
  164.  
  165. rem  ======================================
  166. rem  ----CONVERT INTO ADEPT OUTBOUND
  167. rem  ======================================
  168.  
  169. cd \adept\tools\bink2adept
  170. start /PM bink2adept TOSS %1 %2
  171.  
  172. cd \adept
  173.  
  174.  
  175. ΓòÉΓòÉΓòÉ 2.3. General Settings ΓòÉΓòÉΓòÉ
  176.  
  177. GENERAL SETTINGS 
  178.  
  179.  
  180. In case bink2adept can't get domain, zone and point out of binkley's outbound
  181. i need to have defaults. This occours, when binkley's outbound will be stored in
  182. a directory call "OUTBOUND" instead of nameing directory like domain.(hex of zone).
  183. Don't confound it with your fidonet outbound dir!
  184.  
  185. DEFAULT DOMAIN:       Type in your domain of your main AKA
  186.                       This should normaly be "FIDONET"
  187.  
  188. DEFAULT ZONE:         Type in your zone number
  189.  
  190. DEFAULT POINT:        Don't change this value. Must be zero.
  191.  
  192. MAIN AKA:             Your Main AKA (also know as). Should be
  193.                       your Fidonet AKA
  194.  
  195. ARCHIVER:             Your default mail archiver - don't forget all switches!
  196.                       Default set to ZIP.EXE -m -j
  197.  
  198. LOGFILE:              Complete path and filename for your logfile
  199.  
  200. LOGSTYLE:             Choose between NORMAL and NONE
  201.                       DEBUG log-style isn't ready yet (nice feature, isn't?)
  202.  
  203.  
  204. ΓòÉΓòÉΓòÉ 2.4. PATHES OF YOUR SYSTEM ΓòÉΓòÉΓòÉ
  205.  
  206. PATHES OF YOUR SYSTEM 
  207.  
  208.  
  209. ADEPT OUTBOUND:       Type in complete path of your Adept styled outbound
  210.                       Don't forget a trailing "\"
  211.  
  212. BINKLEY OUTBOUND:     Type in complete path of your Binkley styled outbound
  213.                       Don't forget a trailing "\"
  214.  
  215. AREA.CONTROL:         Type in complete path and filename of your area.control file
  216.  
  217. MESSAGE_AREAS:        Complete path and filename of your message areas file
  218.  
  219. MESSAGE_AREAS.SQUISH: When converting your message areas file into squish i need
  220.                       complete path and filename where to store it
  221.                       DO NOT USE SAME AS YOUR MESSAGE_AREAS !!!
  222.  
  223. MESSAGE BASE:         Complete path to your squish message base
  224.                       Don't forget a trailing "\"
  225.  
  226.  
  227. ΓòÉΓòÉΓòÉ 2.5. SQUISH MESSAGE BASE ΓòÉΓòÉΓòÉ
  228.  
  229. SQUISH MESSAGE BASE DEFAULTS 
  230.  
  231.  
  232. SQUISH.CFG:           Complete path and filename where to store SQUISH.CFG
  233.  
  234. PURGE MESSAGES:       Delete messages according to number of messages
  235.                       0 = don't care
  236.  
  237. PURGE DAYS:           Delete messages according to days
  238.                       0 = don't care
  239.  
  240. CREATE SCO:           When converting into squish, your origin lines can be stripped
  241.                       and stored in a <areaname>.SQO file, which may be used by SQED32
  242.  
  243. AUTORENUMBER MSG:     If you enable this option BINK2ADEPT will automaticly renumber your
  244.                       *.MSG message base. Only rquired if your 3rd tosser can't do that
  245.                       AdeptXBBS currently cannot handle *.MSG, when *.MSG aren't numbered
  246.                       from 1 to X by step 1
  247.                       (can anyone try to translate this for me???)
  248.  
  249.  
  250. ΓòÉΓòÉΓòÉ 3. MENU Tools ΓòÉΓòÉΓòÉ
  251.  
  252.  
  253. ΓòÉΓòÉΓòÉ 3.1. SQUISH Convertor ΓòÉΓòÉΓòÉ
  254.  
  255. MENU TOOLS 
  256.  
  257.  
  258. ADD AREA             {ALT-A} Add a new area (only) to squish.cfg - not ready yet
  259.  
  260. DEL AREA             {ALT-D} Delete an area (only) from squish.cfg
  261.                      After deletion u must enter direct edit of areas! See below ..
  262.  
  263. RENUMBER             {ALR-R} Renumber your FIDO/*.MSG Message base
  264.  
  265. CREATE SQO           {ALT-C} Extract Origin lines out of message_areas into
  266.                      <areaname>.sqo - these files may be used by SQED32 or something else.
  267.  
  268. EXPORT MESSAGE_AREAS related to flags out of message_areas the following function will be used:
  269.                      NETMAIL areas will be converted into FIDO/*.MSG  (FLAGS: +1048576)
  270.                      ECHOMAIL areas will be converted into squish     (FLAGS: +32768)
  271.                      USENET and EMAIL areas  (FLAGS: 8192 btw 65536) will be ignored, because up now
  272.                      they cannot be used with either squish nor FIDO/*.MSG
  273.                      EXISTING files will be over written!!! Also see SETUP.
  274.  
  275.  
  276. EXPORT SQUISH.CFG    This option will create a SQUISH.CFG, including all informations we collected out
  277.                      of message_areas and area.control.
  278.                      EXISTING files will be over written!!! Also see SETUP.
  279.  
  280.  
  281. OTHER KEYS:          DIRECT EDIT (ALT-E) enables direct editing of squish areas listed in th main container
  282.  
  283.                      ENDEDIT (ALT-S) will safe your changes. Use (TAB) or (Shift-TAB) to switch between.
  284.  
  285.                      Drag 'n' Drop:
  286.                      You may change the default listing of areas by simple dragging and droping area names
  287.                      in main container.
  288.                      Important: After a drag'n'drop operation you MUST enter direct edit! Areas MUST
  289.                      be reordered and renumbered by entering direct edit. Hope will find a fix for that.
  290.                      Up now ... mmhhh ...
  291.  
  292.  
  293. ΓòÉΓòÉΓòÉ 4. LAST but not LEAST ΓòÉΓòÉΓòÉ
  294.  
  295.  
  296. ΓòÉΓòÉΓòÉ 4.1. Reports ΓòÉΓòÉΓòÉ
  297.  
  298. LAST BUT NOT LEAST 
  299.  
  300. Some special thanks to  HoRRible  and  HeX
  301.  
  302. BUG REPORTS:  If the program abort, a file "BINK2ADEPT.ERR" will be in your directory.
  303.               please rename it into: <your_name>.ERR and send it to one of the addresses listed below.
  304.  
  305.               You may also send me new ideas for this tool. If it is possible i will add them.
  306.  
  307. Also availble:  ARP206   Adept Request Prozessor 2.06 PM
  308.                 ABS300   Adept Backup System 3.00 PM
  309.                            - New Version - completely rewritten (still in testmode, but coming out soon)
  310.                 FileM    AdeptXBBS filebase mover - corrects files.path - no need to run bfsmake
  311.  
  312.  
  313. You may contact me:
  314.  
  315.                       BBS:      +49-201 - 898524 (V.34 - X.75)
  316.                                 +49-201 - 898598 (X.75)
  317.  
  318.                       email:    Klaus.Ader@rz.ruhr-uni-bochum.de
  319.                       Fido:     2:2448/391.0@Fidonet
  320.  
  321. or much easier on     IRC:      IRC.ISONLINE.COM or IRC.SNOVAL.COM
  322.                       channel:  #Adept  (what else?)
  323.  
  324. cya on streets
  325.              BK
  326.  
  327.  
  328. ΓòÉΓòÉΓòÉ 4.2. COPYRIGHT ΓòÉΓòÉΓòÉ
  329.  
  330. SOME USELESS STUFF: COPYRIGHT 
  331.  
  332. This small tool was written in VX-REXX 2.1d by Watcom Software
  333.                                VX-REXX (c) copyright by Watcom Software
  334.  
  335. AdeptXBBS copyright by AdeptSoft - Portions by M.Kimes
  336.  
  337. BINK2ADEPT (c) copyright by PC-TEAM GbR - K. Ader
  338.  
  339.